home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / mebbs / semailv10.lha / SendEmail.DOC < prev   
Text File  |  1995-09-27  |  7KB  |  195 lines
  1.  
  2.        ****************************************************************
  3.        **   Welcome to SendEmail V1.0, written by M.Valk for the     **
  4.        **   MebbsNet Profesional BBS System created by mr. William   **
  5.        **   Bowling.                                                 **
  6.        ****************************************************************
  7.  
  8.    * This program can be freely spreaded if it's NOT edited, altered
  9.      in any way compared to the original archive.
  10.      It's POSTCARDWARE, which means that IF you intend to use it or
  11.      have it unarchived on your storage device, longer than 2 weeks
  12.      you have to send a postcard to me. See the adress below.
  13.  
  14.      'CopyRight'
  15.  
  16.  
  17. 0. WhatisIt ?
  18.  
  19. This is a MebbsNet Door, you can use it to let your Users send an internet
  20. E-Mail to Internet, it has a simple structure, and it's very easy in it's
  21. usage.
  22. The Door will LOG every action a user did in the door, and a DATA file
  23. with the send message will be appended/created whenever a user dicides
  24. to send a message to internet. The door has a very simple Config where
  25. you can edit the essential information for the door. I do not know if
  26. this setupo for the door is usefull for other settings, if not please write
  27. to me with the necesary information, sothat i can Update my program.
  28.  
  29. 1. Whats Needed to run SendEmail ?
  30.  
  31.   - UUCP V1.17 Proparly setup, the program ONLY uses the UUCP command :
  32.     "UUCP:c/sendmail"
  33.   - A UUCP account to Where you can send the created messages which are
  34.     automatically written to UUSPOOL: by the executed sendmail command.
  35.   - A Config File, included in this archive.
  36.   - Kickstart 2.x or greater cause some variables will be created in your ENV:
  37.     directory.
  38.  
  39. 2. Setting Up SendEmail
  40.  
  41.  - Create a Directory called: Doors:SendEmail
  42.  - Create a Directory called: Doors:SendEmail/DATA
  43.  - Copy The Doorprogram AND the config to the SendEmail directory
  44.  - Edit the config
  45.  - There MUST be a UUCP:c/ directory from where the sendmail command is executed
  46.    that comes with the UUCP package, i have included the program,SO
  47.    the door Executes : UUCP:C/SendMail
  48.  - Create an entry in your menu, do not forget to setup a MinAccess
  49.    if you only want users to use this door with the same or higher
  50.    access than the one you created.
  51.  
  52. 3. Explaining the config settings.
  53.  
  54. Here's an example with the explanation, the door will read the 1st
  55. four entrys in the config file so  be SURE that every variable WILL
  56. be at the line that it supposed to be, NOTHING ELSE MUST BE ON THIS
  57. LINES, Just edit it.
  58.  
  59. ------------------- SendEmail.CFG EXAMPLE
  60. Marco_Valk
  61. marco
  62. Doors:SendEMail/SendEmail.LOG
  63. starbbs.xs4all.nl
  64. ------------------- End SendEMail.CFG EXAMPLE
  65.  
  66. 3.1. Line 1: Marco_Valk
  67.  
  68. * This is the Real Name of your ORIGINAL UUCP Setting, It's the name
  69.   that is in braces after your uucp name, this will be set like this:
  70.  
  71.   SETENV ENV:REALNAME Marco Valk
  72.  
  73.   DO NOT FORGET THE UNDERSCORES !!!!!!!!!, that replaces the whitespaces.
  74.  
  75.   'Explaining the config settings.'
  76.  
  77. 3.2. Line 2: marco
  78.  
  79. * This is your USERNAME, it's the name BEFORE the @, it;s the UUCP Name
  80.   before your DOMAIN Name like:
  81.  
  82.   marco@starbbs.xs4all.nl
  83.  
  84.   SETENV ENV:USERNAME marco
  85.   SETENV ENV:USER marco
  86.  
  87.  
  88.   'Explaining the config settings.'
  89.  
  90. 3.3. Line 3: Doors:SendEMail/SendEMail.CFG
  91.  
  92. * This is the Path AND Name of the Logfile that will be created if a user
  93.   uses the Door.
  94.  
  95.  
  96.  
  97.   'Explaining the config settings.'
  98.  
  99. 3.4. Line 4: starbbs.xs4all.nl
  100.  
  101. * This is your ORIGINAL UUCP DOMAIN Name, the name that is YOUR UUCP
  102.   address, this string will be appended after the '@' string so if your
  103.   USER name is william, than this line will be appended like this:
  104.  
  105.   william@starbbs.xs4all.nl
  106.  
  107.  
  108.   'Explaining the config settings.'
  109.  
  110.  
  111. 3.5. Special NOTES:
  112.  
  113. In the door your ORIGINAL settings are needed, cause everytime a user
  114. enters the door, the REALNAME and USERNAME will be changed to the HANDLE
  115. and REALNAME of the user.
  116.  
  117. After the user leaves the door, all settings WILL be changed automaticcally
  118. to your ORIGINAL settings before the door was ever run.
  119.  
  120.  
  121.  'Explaining the config settings.'
  122.  
  123. 4. Theory of operation.
  124.  
  125.   Once the door is executed, the door will check AND display IF the user
  126. has a HANDLE, this is needed, cause the door needs ONE name, and not
  127. several names, Also i think that a handl is a much better name, cause this
  128. can be edited by the user it'self, while the Realname cannot be edited.
  129. The handle WILL be shown in the door name.
  130.  
  131. Be sure to put on the "Use Handles", in your MebbsCFG, sothat users
  132. automatically will have one before entering the door.
  133.  
  134. Then you have to Give the To: Adress, Subject and edit the text the user
  135. wants to send.
  136.  
  137. After that, the door will display the data the user entered, and it will ask
  138. if he/she wants to sedn the message to internet.
  139.  
  140. If the message is send, the command sendmail (UUCP Command) is executed,
  141. with all parameters from the config AND the message, sendmail will
  142. create the message form for you, and put it in your UUSPOOL: directory sothat
  143. when you call out to collect/send mail and news, the message created by
  144. sendmail will also be send into cyberspace.
  145.  
  146. In the Doors:SendEmail/DATA/ dir, A file WILL be created, the name of the
  147. file is the same name of the user who enters the door, when he/she writes
  148. a message, in that file, the message info of the message he / she sends
  149. to internet, will be logged.
  150.  
  151. Cause this is the sendmail command that will do all the work, i presume
  152. that other setups with AMITCP/MLINK etc will also work, cause the sendmail
  153. command (in UUCP v1.17) has the same parameters in other settings.
  154. Please give me suggestions if you want something else, be sure ALL info
  155. is in your request, sothat i can update the door.
  156.  
  157. 5. Updates & How to kontakt the author:
  158.  
  159. Updates will be available on AMINET in the comms/mebbs directory
  160. and on my WWW side, and can also be requested by the MAGICNAME: "SENDEMAIL"
  161. I can also be reached by Email (off course), and snailmail/voice/data call.
  162.  
  163. Marco Valk
  164. Jan Verfailleweg 470
  165. 1783 B.R. Den-Helder
  166. HOLLAND/NETHERLANDS
  167.  
  168. E-Mail: marco@starbbs.xs4all.nl and/or starbbs@xs4all.nl
  169. Fido  : 2:512/52.0
  170. Data  : +31-223-616836 (Amiga StarLight BBS, V34+/VFAST/HST)
  171. Voice : +31-223-619079
  172. WWW   : http://www.xs4all.nl/~starbbs
  173.  
  174. 6. History & Bugs
  175.  
  176. 27-09-95 1.0 First Release, no known bugs.
  177.  
  178.  
  179. 7. CopyRight
  180.    =========
  181.  
  182.     This program is provided "as is" without warranty of any kind, either
  183.   expressed or implied, including, but not limited to, the implied warranty
  184.   of fitness for a particular purpose.  Though every care has been taken to
  185.   make this program system-friendly and bugs-free, the entire risk as to the
  186.   results, reliability and performance of this program is assumed by you.
  187.  
  188.   All Code is (c) 1995 by Marco A.C.Valk. All Programming and design of
  189.   this package including all associated programs is by - Marco Valk.
  190.  
  191.      Software does not as some of you think come for free. Time and money
  192.   has been spent on developing SendEmail. Many hours have been poured into
  193.   the development of all of the modules.
  194.  
  195.